home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / dev / misc / GuiGFXLib.readme < prev    next >
Text File  |  1999-03-02  |  9KB  |  205 lines
  1. Short:    Application layer for pixel graphics
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (Timm.Mueller@darmstadt.netsurf.de)
  4. Version:  15.0
  5. Type:     dev/misc
  6. Requires: Kickstart 3.0 (v39), MC68020, render.library v29
  7.  
  8. overview
  9. -----------------------------
  10.  
  11.   - guigfx.library is an application layer for pixel graphics.
  12.  
  13.   - guigfx.library breaks the chains of all those nasty
  14.     planar, chunky, 8/16/24bit, OS3.0, OS3.1, OCS, ECS, AGA,
  15.     CybergraphX and Picasso96 considerations.
  16.  
  17.   - with guigfx.library you no longer have to take care about your
  18.     application running on a OCS machine or on a high-end
  19.     graphics-card system.
  20.  
  21.   - guigfx.library lets you freely choose truecolor graphics for
  22.     your applications.
  23.  
  24.   - with guigfx.library your graphics will always look as fine as
  25.     possible, on any screen, no matter if driven on 24 bit
  26.     1024x768 CybergraphX/Picasso96, on HAM8, or 1 bit productivity
  27.     interlaced.
  28.  
  29.   - guigfx.library does quick color-reduction, rendering,
  30.     remapping and dithering for you. only you don't know when,
  31.     on which machine, under what circumstances.
  32.  
  33.   - guigfx.library treats scaling as a standard operation.
  34.     it is available at any time, without extra consideration,
  35.     without extra memory consumption, even without a true loss
  36.     of performance.
  37.     
  38.   - guigfx.library handles screen pen allocation in an extremely
  39.     effective way.
  40.  
  41.   - guigfx.library hides bugs, incompatibilities and insufficiencies
  42.     of graphics.library, cybergraphics.library and Picasso96 from
  43.     you. it is an attempt to render incompatibilities between
  44.     different versions of CybergraphX and Picasso96 obsolete.
  45.     
  46.   - guigfx.library features picture.datatype import. standard and
  47.     v43 (including Picasso96) picture datatypes are automatically
  48.     recognized and used as available.
  49.  
  50.   - guigfx.library does not call SetFunction() and is hereby
  51.     guaranteed to never do so in future versions.
  52.  
  53.   - guigfx.library puts all that stuff into a black-box,
  54.     freeing your mind for the creative part.
  55.  
  56.  
  57. features
  58. -----------------------------
  59.  
  60.   - full truecolor, OCS, ECS, AGA, HAM support
  61.   - screen-pen management
  62.   - color-reduction
  63.   - dithering
  64.   - picture.class datatype import
  65.   - scaling
  66.   - image processing methods 
  67.     (crop, scale, render, tint, 
  68.     alpha-channel, texture-mapping, ...)
  69.   - fully documented
  70.   - supplied with C, Assembler, and E includes
  71.   - freeware
  72.  
  73.  
  74. requirements
  75. -----------------------------
  76.  
  77.   - render.library v29
  78.   - MC68020
  79.   - OS3.0 (v39)
  80.   
  81.   optional:
  82.   higher OS, higher CPU, FPU,
  83.   CyberGraphX or Picasso 96
  84.  
  85.  
  86. recent changes
  87. -----------------------------
  88.  
  89. v15
  90.     - added a few basic examples to the documentation.
  91.     - added GGFX_UseMask for LoadPicture(). if TRUE and supported
  92.       by the datatype, a mask will be read and included to the 
  93.       picture as an alpha-channel.
  94.     - new function: CreatePictureMask(). This function creates
  95.       a single-bitplane mask from a picture's alpha-channel. it
  96.       can be passed to graphics.library/BltMaskBitMapRastPort().
  97.     - CreatePictureBitMap() now accepts a NULL picture. This can
  98.       be used to allocate a blank bitmap that can be blitted
  99.       to a drawhandle efficiently.
  100.  
  101. v14
  102.     - minor bug in MakePicture() fixed: when a blank
  103.       picture was created (data = NULL), the GGFX_Independent
  104.       flag was not set to TRUE internally.
  105.     - PICMTHD_AUTOCROP cropped blank pictures down to zero
  106.       pixels - oops! (evil crashes :-)
  107.  
  108. v13
  109.     - minor internal changes
  110.  
  111.  
  112. ============================= Archive contents =============================
  113.  
  114. Original  Packed Ratio    Date     Time    Name
  115. -------- ------- ----- --------- --------  -------------
  116.      441     183 58.5% 14-Feb-99 00:15:40 +doc.info
  117.     1436     718 50.0% 13-Jul-98 10:47:54 +author
  118.      324     176 45.6% 14-Feb-99 00:15:40 +author.info
  119.      441     190 56.9% 14-Feb-99 00:16:08 +autodoc.info
  120.      324     174 46.2% 14-Feb-99 00:15:40 +examples.info
  121.      324     174 46.2% 14-Feb-99 00:15:40 +history.info
  122.     2181     865 60.3% 13-Jul-98 13:05:44 +legal
  123.      324     180 44.4% 14-Feb-99 00:15:40 +legal.info
  124.      441     188 57.3% 13-Jul-98 12:41:08 +e-mod.info
  125.      441     182 58.7% 13-Jul-98 12:41:08 +examples.info
  126.      450     204 54.6% 13-Jul-98 12:41:08 +fd.info
  127.      450     203 54.8% 13-Jul-98 12:41:08 +include.info
  128.      450     203 54.8% 13-Jul-98 12:41:08 +libs.info
  129.      441     186 57.8% 13-Jul-98 12:41:08 +maxonc.info
  130.      441     186 57.8% 13-Jul-98 12:41:08 +Prefs.info
  131.     3480    1598 54.0% 14-Feb-99 00:24:00 +README
  132.      324     173 46.6% 13-Jul-98 12:41:08 +README.info
  133.    87787   16415 81.3% 13-Feb-99 19:12:50 +guigfx
  134.    77748   15135 80.5% 13-Feb-99 19:11:48 +guigfx.doc
  135.      324     175 45.9% 06-Jan-98 09:17:00 +guigfx.doc.info
  136.      324     216 33.3% 13-Feb-99 19:12:50 +guigfx.info
  137.     3893    1264 67.5% 14-Feb-99 00:21:40 +examples
  138.    16690    6339 62.0% 14-Feb-99 00:36:36 +history
  139.     1712     763 55.4% 21-Jul-98 08:01:08 +prefs
  140.      324     177 45.3% 14-Feb-99 00:15:40 +prefs.info
  141.      482     233 51.6% 14-Feb-99 00:32:42 +guigfx.m
  142.     1444     602 58.3% 14-Feb-99 00:32:42 +guigfx.m
  143.      441     178 59.6% 13-Jul-98 12:35:24 +MystiCube.info
  144.      441     184 58.2% 13-Jul-98 12:37:32 +Plasma.info
  145.      441     183 58.5% 13-Jul-98 12:38:12 +ShadeBobs.info
  146.    35352   21483 39.2% 13-Jul-98 12:34:10 +MystiCube
  147.     1166     530 54.5% 13-Jul-98 12:24:00 +MystiCube.doc
  148.      324     169 47.8% 13-Jul-98 12:35:24 +MystiCube.doc.info
  149.      847     532 37.1% 13-Jul-98 12:35:24 +MystiCube.info
  150.      441     186 57.8% 13-Jul-98 12:35:24 +source.info
  151.    11825   11825  0.0% 26-Oct-97 19:48:08 +MysticLogo.gif
  152.    28482    7133 74.9% 13-Jul-98 12:19:52 +MystiCube.c
  153.     5505    1853 66.3% 08-Jul-98 20:38:34 +mysticube.h
  154.    16448    9779 40.5% 26-Oct-97 19:49:32 +Mystic_Logo.o
  155.      240     179 25.4% 13-Jul-98 12:33:42 +SCOPTIONS
  156.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  157.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  158.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  159.    17664   10619 39.8% 13-Jul-98 12:33:16 +plasma
  160.     1206     546 54.7% 13-Jul-98 12:48:08 +Plasma.doc
  161.      324     177 45.3% 13-Jul-98 12:37:32 +Plasma.doc.info
  162.      358     243 32.1% 13-Jul-98 12:37:32 +Plasma.info
  163.      441     183 58.5% 13-Jul-98 12:37:32 +source.info
  164.      947     368 61.1% 01-Jan-98 01:58:50 +misc.h
  165.    13752    3973 71.1% 15-Dec-97 21:35:52 +plasma.c
  166.      129     107 17.0% 13-Jul-98 12:33:14 +plasma.lnk
  167.      198     154 22.2% 13-Jul-98 12:33:02 +SCOPTIONS
  168.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  169.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  170.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  171.    18472   10641 42.3% 13-Jul-98 12:40:18 +ShadeBobs
  172.     1243     561 54.8% 13-Jul-98 12:48:06 +ShadeBobs.doc
  173.      324     175 45.9% 13-Jul-98 12:38:12 +ShadeBobs.doc.info
  174.      358     243 32.1% 13-Jul-98 12:38:12 +ShadeBobs.info
  175.      441     185 58.0% 13-Jul-98 12:38:12 +source.info
  176.      947     368 61.1% 01-Jan-98 01:58:50 +misc.h
  177.      198     154 22.2% 13-Jul-98 12:33:02 +SCOPTIONS
  178.    15156    4012 73.5% 05-Dec-97 22:52:06 +ShadeBobs.c
  179.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  180.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  181.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  182.     1245     483 61.2% 06-Jan-98 09:17:00 +guigfx_lib.fd
  183.     3155     754 76.1% 06-Jan-98 09:17:00 +guigfx_protos.h
  184.     3183    1018 68.0% 10-Feb-99 22:55:52 +guigfx.h
  185.     2621     899 65.7% 10-Feb-99 22:56:06 +guigfx.i
  186.     1338     414 69.0% 13-Feb-99 03:21:44 +GuiGFX_lib.i
  187.     2427     543 77.6% 26-Jul-98 18:25:42 +guigfx_pragmas.h
  188.      180     128 28.8% 06-Jan-98 09:17:00 +guigfx.h
  189.    43912   22356 49.0% 14-Feb-99 00:26:16 +guigfx.library
  190.    41784   21223 49.2% 14-Feb-99 00:28:22 +guigfx.library_68040
  191.    42208   21370 49.3% 14-Feb-99 00:29:56 +guigfx.library_68060
  192.      441     176 60.0% 14-Feb-99 00:24:16  GuiGFXLib.info
  193.    42200   21370 49.3% 14-Feb-99 00:27:18 +guigfx.library_FPU
  194.      441     180 59.1% 06-Jan-98 09:17:00 +c-libs.info
  195.     5254     853 83.7% 14-Feb-99 00:32:44 +guigfx.lib
  196.      896     461 48.5% 14-Feb-99 00:17:52 +maxon.readme
  197.      324     182 43.8% 06-Jan-98 09:17:00 +maxon.readme.info
  198.      441     183 58.5% 06-Jan-98 09:17:00 +pragma.info
  199.     1792     466 73.9% 14-Feb-99 00:32:44 +guigfx_lib.h
  200.        3       3  0.0% 06-Jan-98 09:17:00 +AUTODITHERTHRESHOLD
  201.        1       1  0.0% 29-Jun-98 05:52:12 +USESCALEPIXELARRAY
  202.        1       1  0.0% 06-Jan-98 09:17:00 +USEWPA8
  203. -------- ------- ----- --------- --------
  204.   580588  230812 60.2% 15-Feb-99 06:13:54   87 files
  205.